home *** CD-ROM | disk | FTP | other *** search
/ X User Tools / X User Tools (O'Reilly and Associates)(1994).ISO / sun4c / archive / tcltk.z / tcltk / man / cat3 / SetVisual.3 < prev    next >
Text File  |  1994-09-20  |  2KB  |  67 lines
  1.  
  2.  
  3.  
  4. Tk_SetWindowVisual(3) Tk Library Procedures
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NAME
  11.      Tk_SetWindowVisual - change visual characteristics of window
  12.  
  13. SYNOPSIS
  14.      #include <tk.h>
  15.  
  16.      int
  17.      Tk_SetWindowVisual(_t_k_w_i_n, _v_i_s_u_a_l, _d_e_p_t_h, _c_o_l_o_r_m_a_p)
  18.  
  19. ARGUMENTS
  20.      Tk_Window      _t_k_w_i_n      (in)      Token for window.
  21.  
  22.      Visual         *_v_i_s_u_a_l    (in)      New visual type  to  use
  23.                                          for _t_k_w_i_n.
  24.  
  25.      unsigned int   _d_e_p_t_h      (in)      Number of bits per pixel
  26.                                          desired for _t_k_w_i_n.
  27.  
  28.      Colormap       _c_o_l_o_r_m_a_p   (in)      New colormap for  _t_k_w_i_n,
  29.                                          which must be compatible
  30.                                          with _v_i_s_u_a_l and _d_e_p_t_h.
  31. _________________________________________________________________
  32.  
  33.  
  34. DESCRIPTION
  35.      When Tk creates a new  window  it  assigns  it  the  default
  36.      visual characteristics (visual, depth, and colormap) for its
  37.      screen.  Tk_SetWindowVisual may be called  to  change  them.
  38.      Tk_SetWindowVisual  must  be  called  before  the window has
  39.      actually been created in  X  (e.g.  before  Tk_MapWindow  or
  40.      Tk_MakeWindowExist  has  been  invoked for the window).  The
  41.      safest thing is to call Tk_SetWindowVisual immediately after
  42.      calling  Tk_CreateWindow.  If _t_k_w_i_n has already been created
  43.      before Tk_SetWindowVisual is called then it  returns  0  and
  44.      doesn't make any changes;  otherwise it returns 1 to signify
  45.      that the operation completed successfully.
  46.  
  47.      Note:  Tk_SetWindowVisual should not be called if  you  just
  48.      want  to  change  a  window's  colormap without changing its
  49.      visual or depth; call Tk_SetWindowColormap instead.
  50.  
  51.  
  52. KEYWORDS
  53.      colormap, depth, visual
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Tk                                                              1
  64.  
  65.  
  66.  
  67.